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3; Version: *v04-000' 
PMPARAAAARLALALALESALASLLELELESELE SELES ESE SESE CECE ACES ECE SECC EEE LOSES ALES aS 


COPYRIGHT (c) 1978, 1980, 1982, 1984 8 
DIGITAL EQUIPMENT CORPORATION, MAYNARD. MASSACHUSETTS. 
ALL RIGHTS RESERVED. 


THIS fo ere 4 waiters UNDER A LICENSE AND MAY 
ONLY yy ACCORDANCE WITH THE TERMS OF such LIC 


3 


THE INFORMATION IN THIS SOFTWARE IS SUBJECT TO CHANGE WITHOUT NOTICE 
—8B 2 NOT BE CONSTRUED AS A COMMITMENT BY DIGITAL EQUIPMENT 


DIGITAL ASSUMES NO RESPONSIBILITY FOR THE USE OR RELIABILITY OF ITS 
SOFTWARE ON EQUIPMENT WHICH IS NOT SUPPLIED BY DIGITAL. 
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Revision his M 
v03-03 RO410 Michael I. Rosenblum 11-Apr-1984 
Make Unit init macro store the default parity setting 
in the ucb from the system location. 


v03-034 nine 340 Michael I. Rosenblum 15-Mar-1984 
X setne label to CLASS_ CTRL_INIT generate all others 
Propt gete ot BLOBAL flag thru “S$TTYBEFS to get symbols defined 


v03-033 m1RO0070 Michael I. Rosenblum 13-jul-1983 
Add macros CLASS "UNIT. INIT and CLASS_CTRL_INIT. 
v03-032 JL VO0S2 | an e Vanno 
Create TTYMACS.MAR pet TTVBEF .SDL. Move STTYDEFS and $STTYMODEM 
and STTYDEF to TTYDEF. 
v03-031 wxsoost RICK SPITZ 18-APR-1983 
ADD NEW INTERNAL FUNCTION DEFINITIONS ro 8 LLO 
E EFFICIENT STARTIO DISPATCHING OF ONC TIONS . 
ADD DEFINITIONS FOR PORT AUTOXOFF FEATURE 
v03-030 mIRO031 Michael I. Rosenblum 11-Apr-1983 


Add bits to enable the user to spect ty frame size, tnd non-interuptable 
multiecho's. Add in alternate echo string data structures. 


v03-029 MIRO029 Michael I. Rosendlus 21-Mar-1983 
Add bit to allow a standard terminator set to be ignored 


N 
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and insert/overstrike toggel. 


v03-028 RKS0028 RICK SPITZ 14-MAR-1982 
RENAME REDUCB FIELD TO PHYUCB 
v03-027 MIR1026 Michael I. Rosenblum 01-Mar-1983 


Add broadcast cless quad word, fields to allow multiecho 
to be one level recursive, space for a backspace count, and 
an area in the typeahead buffer to handle recall of the Last 


command. 

V03-026 MIRO026 chael I. Rosenblum 11-Feb-1983 
Add locations to "point to dispatch tables for input 
character dispatching. 

v03-025 RKS0023 RICK SPITZ 05-FEB-1983 
ADD DEFINITIONS TO SUPPORT DMA IN YCPORT LEVEL 

v03-024 MIROO25 Mic —* 1. Rosenblum 11-Feb-1983 


add modifiers tong word to the coratact read buffer 
structure. Add item List definitions. 


V03-023 MIROO24 Michael I. Rosenblum 26-Jan-1983 
Change read packet definition, to allow more flexibility 
and a clean implimentation of both input editing and 
read ‘vith verifycation. 


v03-022 MIROO22 Michael I. Rosenblum 19-Jan-1983 
add UCBSW_TT _UNITBIT Word that contains one bit set 
to indicate Chih unit this | ne is, used by modem 
gontres and D must be set for alt controlers. 
norge CRB 9 ae definitions into the main system 
definition file. 


v03-021 RKSO0021 RICK SPITZ 13-JAN-1983 
REPAIR PROBLEM WITH PORT VECTOR MACRO 
v03-020 M1IRO018 Michael I. Rosenblum 07-Jan-1983 


Add macro to build the port driver entry table. This 
macro will allow us to rearrange the port table at our 
discression and only require assembaling and relinking 
of the port driver. 


v03-019 M1RO017 Michael I. Rosenblum 04-Jan-1983 
Add power foil bit te the un at. stote vector and 
chess powerfail callback. Th 
b low us to * the power fail checks in the class driver 
n only one place. 


v03-018 mipoeie Micheal I. Rosenblum 29-Dec-1982 
2 macro ond TTYSV_PC_NOTIME bit. 
+4 TIMSET macro should * tare o att the places 
where duetim and the TIM bit are normaly set. 


v03-017 MIROO15 Michael I. Rosenblum 21-Dec-1982 
Add CLASS DISCONNECT CLASS_FORK, and PORT_FORK vector 
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entry P points 
Add FD fork — bit table. 


VO3-016 MIROO14 ael I, Rosen 17-Dec-1982 
change xon and Re J ts in a tt tank to reflect 
the change of functionality in thé xdn and xoff port 
driver functions. 


v03-015 MIROO13 Michael I. Rosenblum 14-Dec-1982 
Split TTYDEFS into the following sections: 
TTLOGDEF The logical terminal UCB extensions 
TTCLSDEF Theterminal class driver and 
port driver independant extensions 
TTPRIDEF The-terminal port driver dependent 
region, _TP_. 
v03-014 MIROO11 chael I. iResgne hus 18-Nov-1982 


Change detinition : removi ng it from the first state longword 
—* Ls «ay merce e that the prompt string is being clocked 

en 
—* 2 atete “bit to the first conguerd. This bit indicates 

a read editing string is being outp 

hog SKIPCRLF to the second state lon — This bit indicates 
that the Linefeed following a CR in the beginning of the 
prompt string is to be skipped. 


v03-013 MIROO10 Michael I. Rosenblum 09-Nov-1982 
Add Ge fin 1*4 as follows: 
TTYSL_RB_TERM Address of the terminator mask 
(either standard mask or new mask 
in the read packet). 
TTYSW_RB_PRMPT Offset from the beginnin of the 
sve packet to the end of the prompt 
tr 
TTYSW_TA_INAHD The nunber of characters currently in 
typeahead buffer. 


v03-012 RKS0012 RICK SPITZ 05-APR-1982 
CONVERT SPARE BYTE INTO CURRENT OUTPUT ESCAPE RULE 
v03-011 RKS0011 RICK SPITZ 11-JAN-1981 
ADD EXTENSION REGION FOR READ BUFFER HEADER 
v03-010 RKS001 RICK SPITZ 15-DEC-1981 
ADD NEW CONTROL DEFINITION FOR CHARACTER, TYPE TABLE. 
LOWER CASE DEFINITION BIT FOR TYPE TABLE. 
ALTERNATE DRIVER LOCATION IN UCB. 
MAP, ALTLEN SPARE IN UCB. 
MOVE LINE DISABLE BIT IN MAINT JELD. 
ADD IDB FIELD DEFINITION FOR D232. 
v03-009 BLsot 16 Benn Schreiber 2-Dec-1981 


Correct IF_NOT_STATE macro 
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v03-008 juvole? 28-0c¢t-1981 
Add NOSET, NOCLEAR, *WOMOD. yPRIV TO_MOD to STTYMACS. 
pe add one bit pita to IF_STATE and IF _NOT_STATE. 

v03-007 JLV oy 28-0c t-1981 
changed TTYDEFS * — Move STTYDEF from SYSDEF 
to this module. 

V03-006 PHLO0020 r H. Lipman 27-0¢t-1981 
Moved TT_DEVDP1 te fixed or ton of UCB. It isa 
synonym for the new DEVDEPND2 cell. 

v03-005 JLV0089 Noy 99-Sep-1981 

Added AUTOP, —— pend ng timout. 

V03-004 RKS004 RICK SPITZ 26-AUG-1981 
MOVE ROUE EARLIER IN UCB TO ALLOW EASIER EXTENSION OF UCB 

v03-003 RKS0003 RICK SPITZ 20-AUG-1981 


ADD NEW STATE BIT DEFINITIONS 
ADD OUT OF BAND SUMMARY MASK AND QUE HEAD. 


v03-002 RKS0002 Rick Spitz 27-JULY-1981 
Restructure device dependent portion of UCB and 
add new UCB fields for * control,split speed 
and output ORT TE et SS tion 
Redefine IF_STATE GTSBITS Macros to allow quadword 


state field. 
Add modem definitions for DECOS2 modem control 


v03-001 RKSO0001 RICK SPITZ 13-NOV-1980 
Revise Ucb extensions for terminal driver 


; THEY 
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; THESE MACROS ARE USED TO GENERATE CODE FOR I 
; GE a A SEQUENCE OF ONE OR TWO BIT(?) 
; OR BIS(?2) INSTRUCTION COMBINATIONS DEPENDING 
; BITS BEING TESTED IN THE STATE QUADWORD. 


> TERMINAL DRIVER MACROS 


-MACRO STTYMACS 
sMACRO GTSBITS BITS,MODE,TARGET,BRANCH, ?L1 


L 32-T 
IF LT X1-21 
-ENDC 
Wi=<TTYSM_ST_"Y>!w1 
-ENDC 
IF GT 32-T 
x0=Ta-3 
IF LT x0-20 
20=x0 
- ENDC 
te ee 


? wO 

GTSBITS1 20,WO, MODE ,0 
NB ARGET 

cIF IDN BRANCH ,BEQL 


BRANCH ,BEQL 


E WI 
GTSBITS1 Z1,W1 


theefe 
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F STATE MACROS. 
ON THE SEPERATION OF THE 


MN 
@ 


Fy 
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.ENDC 
TENDC 
cIF NE F 

Li: 
.ENDC 
“ENDM  GTSBITS 
-MACRO GTSBITS1 2,WX,MODE ,BIAS 
WX=WXa-<7*8> 
X=WXa- 
IF EQ x 
BI 'MODE'B #WX ,BIAS+#Z(R2) 
K=WXa-16 
IF EQ x 
BI *MODE"w #WX ,BIAS+2(R2) 
B1'MODE'L #WX ,BIAS+2(R2) 
.ENDC 
SENDC 
-ENDM GTSBITS1 
.MACRO SET STATE NAME 
GTSBITS <NARE> 
.ENDM SET nSTATE 

CRO CLR_STATE NAME 

GTSBITS <NAME>,C 
-ENDM—CLR_ STATE 
.MACRO_ IF_STATE NAME , TARGET 
CNT = 0 
~ IRP y E> 
CNT = CNT + 1 
-ENDR 
.IF EQUAL CNT = 1 
ONE »B1T <NAME>,S, TARGET 
GTSBITS <NAME>,1, TARGET, BNEQ 
-ENDM = IF_STATE 


.MACRO_ IF_NOT_STATE NAME, TARGET 
tnt = 0 


~ IRP Y,<NAME> 
on : CNT + 1 


IF EOyAL CNT - 1 
IT <NAME>,C, TARGET 


TS <NAME>,1T, TARGET ,BEQL 
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-ENDM 


F 
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IF _NOT_STATE 


-MACRO ONE _BIT Ott een TAR 
#TTY$V 


BB* BRANCH’ 


~ENDM 


¢ TARGET 
“SX_"BIT', (R2), "TARGET® 
ONE _B1T 


Bit checking for setmode/char changes to og yoernes- Assumes 
RO = input, R1 = Bits changing, R3 = IRP, RS = UCB. 


BICL 


Li: 


-ENDM 
-MACRO 
BBC 
BISL 


Li: 


-ENDA 
-MACRO 
XORL2 


L1: 


- END 
-MACRO 
BBC 
BITL 


BNEQ 
BRW 


L1: 


NOSET 
NOCLEAR BIT, 
#TTO$V_'BIT 
#TT2SM~ "BIT". 
NOCLEAR 


PRIV_TO_MOD 1 pbc = NOPRIV_EXIT,?L1 


L 
{0>!- 


<1aPRV$V_PAY_10>>,- 


I 
O1RPSL_ARB(R3) 
"ERROR' 
PRIV_TO_MOD 
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* TIMSET = macro to handle setting timeout's 
TIMSET 


Description: 

Chis norte handles all of the timesetting needs of —*G terminal 
driver. It will —- the port control word before any action to determine 
if timeouts are required for this device. 


Inputs: 
LEN = Location conte intes the length of the string 
OR if WORK is blank 
The minimum number of seconds to wait. 
WORK = Temp register. If blank alternate form of this macro 


is generated to wait for a constant time 
INTEXP = if not blank then the interupt expected bit is set 


Be ee Ce Se Se Ge Ge Se Se Se Geese Se Se Se Se Se ese oe 


-MACRO TIMSET LEN,WORK,INTEXP,?L1,?L2 
NB INTEXP 


IF N 
BBC #TTYSV_PC_NOTIME ,UCBSW_TT_PRTCTL(RS) ,L1 
BBCS #YCBSV_INT UCBSH_STS(RS) Ce 
* BRB L 
sth BBS #TTYSV_PC_NOTIME ,UCBSW_TT_PRTCTL(RS) .L2 
Li: 
IF B WORK 
* ADDL3 #LEN+1,G*EXESGL_ABSTIM,UCBSL_DUETIM(RS) ; SET TIME OUT 
DIVL3 #4,LEN,WORK 
ADDL K 
ADDL3 WORK,G*EXESGL_ABSTIM,- 
UCBSL_DUETIM(RS) 
.ENDC 
-IF NB INTEXP 
BISB #UCBSM INT !UCBSH_TIM,~ 
* UCB$W_STS(R5) 
BISB #UCBSM_TIM,- 
UCBSW_STS(RS5) 
.ENDC 
L2: 


H 
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. SVECINI = Macro to start the port vector table 
SVECINI 
Description: 
This macro will generate a port entry vector table and a 


null entry point for a port driver. Initialy this table will be 
filled with colts to the null entry point and eee, n by later 


; calls to the SVEC macro. This macro generates the $VEC macro and 
; the SVECEND macro 
Inputs: 
DRIVERNAME = The two letter driver prefix 
PREFIX = 


Spe tenets Prefix to be added to the symbols in Later 
alls to SVEC. Defaulted to PORT_. 


Implicit Inputs: 

PREFIX_LENGTH = Number of bytes in the maximum size table. 
Generated Labels: 

drivernameSVEC = The start of the vector table 


drivernameSVECEND = The end of the vector table 
drivernameSNULL = Null entry point (RSB) 


Oe Se Oe Ge Se Se Ge Se Se Oe Oe Ge Ge SF Se SH S6 Oe Se Se Se OH Se Se Se Sees ee 
* 


-MACRO SVECINI DRIVERNAME ,NULL_ROUTINE ,PREFIX=PORT_ 
*DRIVERNAME 'SVEC: 
-REPEAT "PREFIX LENGTH/4 
.LONG NULL_ROUTINE 


»ENDR 
*DRIVERNAME * SVECEND: 
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* SVEC = Validates and generates vector table entry 

$VEC 

Description: 
This macro will validate and generate a vector table entry. 

The position of this entry in the ven tor table may change from 

version to version but the use of this macro will always generate 

a working vector table or it will generate an error. 
This macro call must follow a SVECINI call. 

Inputs: 


ENTRY = The name of the table entry 
ROUTINE = The name of the routine. 


-MACRO $VEC ENTRY ,ROUTINE 
-1F NDF PREFIX* ‘ENTRY 
-ERROR ; table location PREFIX''ENTRY undefined 


o IFF 

-=DRIVERNAME 'SVEC+PREFIX* ‘ENTRY 

-I1F GE .=-DRIVERNAME 'SVECEND 

25 : Table location PREFIXENTRV out of range 


y .LONG ROUTINE 
-ENDC 


-ENDM S$VEC 
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SVECEND = Generates the ending code for a vector table 
SVECEND 
Description: 


Will generate the vector tables null routine and 
set the location counter to the correct place. 


Inputs: 
⸗ END = Blank if this is the end of the table 
non blank if the end of the table is not to be generated 


-MACRO. SVECEND END 
-='"DRIVERNAME ‘SVECEND 
-lIF 8 -LONG 0 


ANK, END 
.ENDM’ $VECEND 
.ENDM = SVECINI 


BeGe Ge Se Se Ge Ge Ge Ge Se Geese ee 
+ 


K 
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3** 
; Class_Ctrl_init = Macro to generate code controler init code common to all 
3 port drivers 


: booerves rene 

3 his macro is provided to make sure thay at “ the port Gr ivers 

; have a common set of controler-init code. sm r9 is required to 

; be part of every terminal port driver's tentroler” nit code. 

: Inputs: 

: DPT = the symbolic name of the port's Driver prologue table 

VECTOR - tre address of the port dispatch table generated with 
he SVEC macro. 

emacro CLASS_CTRL_INIT DPT, VECTOR, ?2L1,?L2,?7L3,?2L4 

MOVL G*TTYSGL_DPT,R1 3; LOCATE CLASS DRIVER TO 

MOVIL DPT$W_VECTOR(R1) RO ; GET AD 

ADDLS RO,RIUR ; CALCULATE VIRTUAL ADDR 


; RELOCATE CLASS VECTOR TABLE 


(RO) ; ALREADY RELOCATED OR DONE? 
R1,(RO)+ ; ADD BIAS 
L1 ; LOOP TILL DONE 

VECTOR TABLE 

VECTOR, RO 

(RO) ALREADY RELOCATED OR DONE? 


L4 
R1,(RO)+ 
L3 


class_ctrl_init 
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CLASS -UNIT_INIT = Macro that contains the code that the [: ss driver 
needs in all of the port drivers unit t routines 


Soncrtgs ent 

his macro provides +e *2 F. allowing the class poli yo 
some code in every port drivers unit init routine. iai8 routine 
should be assumed black magic in the port driver as it 
contents and agorithms may be changed from release to release. 


Inputs 
4 RO - goqvatng ¢ the address of the port dispatch table for 


See Se Geese Ge Ge Ge Se Geese Se ee 
$ 


-macro EL ASS ett UNIT _INIT,?11 


MOVL ; ADDRESS OF CLASS DPT 
MOVZWL DPTS$W_ VECTORERT) »R2 + LOCATE CLASS DRIVER VECTOR TABLE 
ADDL : RELOCATE BASE A 

MOVL  R1,UCBSL_TT_CLASS(RS) : SET TERMINAL cage DRIVER VECTOR 
MOVL RO,UCBSL_TT_PORT(RS) —_; SET PORT VECTOR TABLE ADDRESS UP 
MOVL  CLASS_ GETNXT(R1) /UCBSL_TT_GETNXT(RS) 

MOVL  CLASS~ =PUTNKT(R 1) {UCBSL-TT=PUTNXT (RS) 

MOVL  UCBS$L~DDB(RS) .R2- ; GET DDB ADDRESS 

MOVL ants “DDT(R1) .DDBSL_DD Re) 

MOVL CLASS~DDT(R1) .UCBSL~DDT(RS) ; SET DDT ADDRESS IN UCB 


HIS ISN'T POWER FAIL 
THEN SET THE DEFAULT 


T 
T 
BBS wycesy ¥ POWER UCBSW, s15¢ 
TT” : PARITY SETTINGS 


rr GAT TYG PARITY ,UCBSB_ 


-endm = class_unit_init 
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STO_TQE = Modem TQE macro 


«MACRO 
= 


= 
» SIZE 
= 


-MACRO 
-ENDM 


-ENDM 


STO_TQE OFFSET,SIZE,VALUE,BASE 
OF FSET#BASE 

Yet 

STO_TQE 


STTYMACS 
STTYMACS 


STTYMACS 


0.35 
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: TERMINAL DRIVER DEFINITIONS 


-MACRO STTYDEFS S$GBL 

SDEFINI TTYDEFS,$GBL 

SUCBDEF $GBL 

SCRBDEF seat ; DEFINE CRB,IDB OFFSETS 
SIDBDEF GBL 

STTYUCBDEF $GBL 3; UCB Extension 
STTYVECDEF GBL 3; Class and Port Vectors 
STTYSYMDEF GBL 3; Misc Symbols 

STTYRBDEF $GBL 3; Read Buffer 

STTYISDEF $GBL 3; Input Stack 

STTVILDEF $GBL : Itemlist Descriptor 
STTYTADEF $GBL 3; Typeahead buffer 
SDEFEND TTYDEFS,S$GBL,DEF 

.ENDM = STTYDEF§ 
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STTYMODEM exists here so that the name change to STTYMDMDEF 
can happen without changing the driver. This should be cleaned 
up when convenient. 


MACRO $TTYMODEM $GBL 
$DEFINI TTYMODEM, SGBL 


STTYMDMDEF 3; Define equivalent name 


SDEFEND TTYMODEM,$GBL ,DEF 
-ENDM $STTYMODEM 


END 
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